package com.danciyixue.boot.dcyx.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.danciyixue.boot.dcyx.model.entity.Words;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.danciyixue.boot.dcyx.model.query.WordsQuery;
import com.danciyixue.boot.dcyx.model.vo.WordsVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 单词信息Mapper接口
 *
 * @author youlaitech
 * @since 2025-06-15 16:23
 */
@Mapper
public interface WordsMapper extends BaseMapper<Words> {

    /**
     * 获取单词信息分页数据
     *
     * @param page 分页对象
     * @param queryParams 查询参数
     * @return {@link Page<WordsVO>} 单词信息分页列表
     */
    Page<WordsVO> getWordsPage(Page<WordsVO> page, WordsQuery queryParams);

    /**
     * 随机获取指定教材的单词
     *
     * @param programId 教材ID
     * @param limit 获取数量
     * @return 单词列表
     */
    List<Words> getRandomWordsByProgramId(@Param("programId") Long programId, @Param("limit") Integer limit);

    /**
     * 随机获取指定教材的单词，排除指定的单词ID列表
     *
     * @param programId 教材ID
     * @param excludeIds 要排除的单词ID列表
     * @param limit 获取数量
     * @return 单词列表
     */
    List<Words> getRandomWordsByProgramIdExcluding(@Param("programId") Long programId,
                                                   @Param("excludeIds") List<Long> excludeIds,
                                                   @Param("limit") Integer limit);

    /**
     * 根据单元ID获取所有单词
     *
     * @param unitId 单元ID
     * @return 单词列表
     */
    List<Words> getWordsByUnitId(@Param("unitId") Long unitId);

    /**
     * 随机获取指定教材的单词，排除指定单元ID
     *
     * @param programId 教材ID
     * @param excludeUnitId 要排除的单元ID
     * @param limit 获取数量
     * @return 单词列表
     */
    List<Words> getRandomWordsByProgramIdExcludingUnit(@Param("programId") Long programId,
                                                       @Param("excludeUnitId") Long excludeUnitId,
                                                       @Param("limit") Integer limit);

    /**
     * 根据单词ID列表查询单词拼写
     *
     * @param wordIds 单词ID列表
     * @return 单词拼写列表
     */
    List<String> getWordSpellingsByIds(@Param("wordIds") List<Long> wordIds);

}
